length Property (Function) (JScript 5.6)


functionName.length

The required functionName is the name of the function.

The length property of a function is initialized by the scripting engine to the number of arguments in the function's definition when an instance of the function is created.

What happens when a function is called with a number of arguments different from the value of its length property depends on the function.

The following example illustrates the use of the length property:

┬á	Copy Code
function ArgTest(a, b){ var i, s = "The ArgTest function expected "; var numargs = ArgTest.arguments.length; var expargs = ArgTest.length; if (expargs < 2) s += expargs + " argument. "; else s += expargs + " arguments. "; if (numargs < 2) s += numargs + " was passed."; else s += numargs + " were passed."; return(s); }

┬á

Copy Code

function ArgTest(a, b){
   var i, s = "The ArgTest function expected ";
   var numargs = ArgTest.arguments.length;
   var expargs = ArgTest.length;
   if (expargs < 2)
      s += expargs + " argument. ";
   else
      s += expargs + " arguments. ";
   if (numargs < 2)
      s += numargs + " was passed.";
   else
      s += numargs + " were passed.";
   return(s);
}

Version 2

Applies To: Function Object (JScript 5.6)

Reference

arguments Property (JScript 5.6)
length Property (Array) (JScript 5.6)
length Property (String) (JScript 5.6)

Remarks

Example

Requirements

See Also

Reference